Voraussetzungen

Postgres bzw. Informix IDS ist gestartet und läuft, der User existiert im Datenbanksystem hat das Recht, Datenbanken zu erzeugen, Java ist installiert.Auf dem Server sollte kein weiterer Server-Dienst auf den Ports 8005, 8009 und 8080 (Tomcat-Standard-Ports) laufen.

Entpacken

Entpacken Sie das Kernmodul in /home/superx

tar -xzvf kernmodul<<Versionsnr>>.tar.gz

Umgebungsvariablen

Gehen Sie in das Verzeichnis db/bin

cd db/bin

Kopieren Sie SQL_ENV.sam nach SQL_ENV

cp SQL_ENV.sam SQL_ENV

Wenn Sie die Datenbank superx unter Linux in /home/superx mit Postgres als DB-Server und Java im Verzeichnis /usr/lib/java installiert haben, brauchen Sie nichts ändern.
Ansonsten passen Sie $SUPERX_DIR, $JAVA_HOME, $DATABASE, $SX_CLIENT, $LANG und $MAILPROG an

Starten Sie das Script mit

. SQL_ENV

und fügen Sie den Aufruf am Ende der Datei ~/.bashrc ein:

. ~/db/bin/SQL_ENV

Einspielen der Datenbank

Gehen Sie in das Install-Verzeichnis

cd $SUPERX_DIR/db/install

Starten Sie das Script

kernmodul_erzeugen.x <<ggf. mit Name des DBSpace>>

Bei Fehlern kommt eine Meldung, Protokolle stehen in
create.log

Damit ist die db-Seite eingerichtet.

Steuerungsdatei für das Servlet:
 db.properties

Nun gehen Sie in das Verzeichnis

cd $SUPERX_DIR/webserver/tomcat/webapps/superx/WEB-INF

Kopieren Sie db-postgres.properties bzw. db-informix.properties nach db.properties

Beispiel für Postgres:

cp db-postgres.properties db.properties

Staten Sie den PropAdmin mit

propadmin.x

Passen Sie hier den Servernamen, Datenbanknamen, Usernamen und Passwort an, und drücken Sie "Verbindung testen"

Danach speichern Sie die Datei.

Connection Pool für dbforms

Editieren Sie die Datei SUPERX_DIR/webserver/tomcat/conf/server.xml und passen Sie am Ende im Abschnitt <ResourceParams name="jdbc/superx"> die Verbindungsparameter an, die Sie oben auch dem SuperX-Servlet gegeben haben (also driverClassName und url).

Steuerungsdatei für das Applet:
 superx.properties

Nun gehen Sie in das Verzeichnis $SUPERX_DIR/webserver/tomcat/webapps/superx/applet

cd $SUPERX_DIR/webserver/tomcat/webapps/superx/applet

Kopieren Sie die Datei superx-postgres.properties.sam bzw.
superx-informix.properties nach
superx.properties

cp superx-postgres.properties superx.properties

Editieren Sie die Datei, und tragen Sie bei SxTitle den Hochschulnamen ein.
Wenn Sie Informix benutzen, muss bei SxDB "Informix" stehen, bei Postgres "Postgres"

Start von Tomcat

Nun wechseln Sie in das Verzeichnis

cd $SUPERX_DIR/webserver/tomcat/bin

Und starten tomcat mit

startup.sh

(Stop übrigens mit "shutdown.sh".)

Und los geht?s...

Nach erfolgreichem Start rufen Sie im Browser auf

http://localhost:8080/superx/

Dort können Sie das Applet und das XML-Frontend aufrufen. Geben Sie bei der Kennung superx ein, und als Passwort
"anfang12"

Feineinstellung

Melden Sie sich im XML-Frontend an und gehen Sie im Menü auf "Tabelle suchen", klicken einfach "Abschicken" und öffnen Sie die Tabelle hochschulinfo; dort sollten Sie Ihre Hochschule auswählen und "Speichern" anklicken, damit Ihre Hochschulnummer gespeichert wird.